Handle duplicate bin names when upgrading

The persistent yard model allows duplicate section names. Some sites rely on duplicate section names, for example, to accommodate wheeled work flows. When you use Yard Editor to upgrade your yard model, you can choose to be alerted to duplicate yard section names by adjusting the YRDCORE001 (ALLOW_DUP_BIN_NAME_FOR_YARD_SECTIONS) (on page 1) setting.

When YRDCORE001 is set to:

• TRUE (default), N4 tolerates duplicate section names and alerts you to duplicate stack names.

You must resolve duplicate stack names before you can apply the yard model to the active yard, but you may keep duplicate section names.

• FALSE, N4 tolerates duplicate section names in non-active yard models but alerts you to duplicate names on both the section- and stack-level. For example:

Name AB01 of Yard section with row index 1 of block ABB conflicts with Yard section with row index 1 of block AB.

You must resolve any duplicate names before you can apply the yard model to the active yard.

If terminals with multiple facilities want to allow duplicate sections at one yard but not at another, they can override the setting at the facility scope level by logging in to each facility.

When upgrading the yard, as part of the automated upgrade actions, N4 converts the existing yard's compiled yard file to the persistent bin model. If setting YRDCORE001 is set to TRUE:

• N4 continues the upgrade process if it encounters duplicate section names but no duplicate stack names.

• N4 stops the upgrade process if it encounters duplicate stack names, regardless of section names.

If YRDCORE001 is set to FALSE, N4 stops the upgrade process if it encounters any duplicate bin name for either section or stack.

When the upgrade process stops, N4 continues with the next upgrade action. When all N4 nodes are started, the yard model exists, but it is not active because of duplicate stack bin names.

After upgrading, always verify the apex logs and look for duplicate yard stack or section errors.

To proceed if the upgrade process stops due to duplicate bin names:

1. Eliminate duplicate bin names in the yard source file.

2. In the N4 interface, create a new yard model. (Configuration Models Yard Models Yard Models view Click Add Yard Model form)

3. Using an internet browser to access the Yard Editor, import the modified yard file. (Models Yard Models Yard Models view Actions Open Yard Editor Yard Editor view Actions Import  Compiled Yard File Import Compiled Yard File form).

4. When prompted to reset geometries, click No.

5. Select Actions Apply Yard Model Changes.

6. When the process finishes without errors, verify in the Yard Models view that the yard model is active.